home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / docs / corsoguide / stringinfo-18.txt < prev    next >
Text File  |  1992-09-03  |  3KB  |  72 lines
  1. Struttura StringInfo
  2.  
  3. Riportiamo e descriviamo la struttura StringInfo per i gadget stringa
  4. struct StringInfo
  5. {
  6.   UBYTE *Buffer;
  7.   UBYTE *UndoBuffer;
  8.   WORD BufferPos;
  9.   WORD MaxChars;
  10.   WORD DispPos;
  11.   WORD UndoPos;
  12.   WORD NumChars;
  13.   WORD DispCount;
  14.   WORD CLeft, CTop;
  15.   struct StringExtend *Extension;
  16.   LONG LongInt;
  17.   struct KeyMap *AltKeyMap;
  18. }
  19.  
  20. Buffer
  21. L'applicazione deve fornire un vettore di caratteri (stringa) in cui
  22. Intuition memorizza la stringa inserita dall'utente; il puntatore a tale
  23. vettore deve essere inserito in questo campo; la dimensione del vettore non
  24. deve essere inferiore a MaxChars; il testo presente nel vettore prima di
  25. inserire il gadget nella finestra, verrà visualizzato al momento
  26. dell'inserimento di quest'ultimo; se il gadget è di tipo Integer bisogna
  27. memorizzare la codifica ASCII del numero preinserito.
  28.  
  29. UndoBuffer
  30. E' il puntatore al buffer di caratteri per l'operazione di undo (opzionale);
  31. l'operazione di undo permette di ripristinare il contenuto precedente alle
  32. modifiche; l'UndoBuffer può essere condiviso da più string gadget (dato che
  33. un solo string gadget alla volta può essere attivo), attenzione ad usare un
  34. numero di caratteri corrispondente alla massima esigenza fra tutti i string
  35. gadgets.
  36.  
  37. MaxChars
  38. Indica il numero massimo di caratteri che la stringa può avere; questo
  39. valore comprende anche il NULL di fine stringa, quindi il numero effettivo
  40. di caratteri memorizzabili è MaxChars-1.
  41.  
  42. BufferPos
  43. BufferPos è inizializzato con il valore della posizione del cursore nel
  44. buffer della stringa; questo valore varia da 0 alla lunghezza della stringa
  45. meno 1.
  46.  
  47. DispPos
  48. DispPos indica il primo carattere visualizzato nel gadget; può accadere che
  49. se la stringa inserita è più lunga della capienza grafica del gadget, il
  50. testo viene fatto scorrere all'interno di quest'ultimo.
  51.  
  52. UndoPos, NumChars, DispCount, CLeft, CTop
  53. Queste variabili sono mantenute da Intuition e non dovrebbero essere
  54. modificate da Intuition. UndoPos specifica la posizione del carattere nel
  55. buffer undo; NumChars specifica il numero di caratteri correntemente
  56. presenti nel buffer; DispCount specifica il numero di caratteri
  57. attualmente visualizzati nel gadget.
  58.  
  59. Extension
  60. Permette di specificare un ulteriore struttura estensiva per ulteriori
  61. controlli sul gadget
  62.  
  63. LongInt
  64. Contiene il valore intero inserito nel gadget se il gadget stringa è di
  65. tipo Integer.
  66.  
  67. AltKeyMap
  68. Per default i caratteri sullo schermo appaiono mediante una semplice
  69. trasformazione in ASCII; volendo utilizzare una KeyMap alternativa bisogna
  70. specificare il puntatore alla struttura KeyMap relativa in questo campo e
  71. impostare GACT_ALTKEYMAP nel campo Activation del gadget.
  72.